001    /*
002     * Copyright (c) 2005 Stephen J. McConnell
003     *
004     * Licensed  under the  Apache License,  Version 2.0  (the "License");
005     * you may not use  this file  except in  compliance with the License.
006     * You may obtain a copy of the License at
007     *
008     *   http://www.apache.org/licenses/LICENSE-2.0
009     *
010     * Unless required by applicable law or agreed to in writing, software
011     * distributed  under the  License is distributed on an "AS IS" BASIS,
012     * WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
013     * implied.
014     *
015     * See the License for the specific language governing permissions and
016     * limitations under the License.
017     */
018    
019    package net.dpml.component;
020    
021    import java.net.URI;
022    
023    /**
024     * Exception thrown by a local handler that wraps an exception thrown 
025     * by a foreign handler.
026     *
027     * @author <a href="http://www.dpml.net">Digital Product Meta Library</a>
028     * @version 1.0.2
029     */
030    public class DelegationException extends ControlException 
031    {
032       /**
033        * Serial version identifier.
034        */
035        static final long serialVersionUID = 1L;
036    
037        private URI m_target;
038    
039       /**
040        * Creation of a new delegation exception.
041        * @param uri the uri of the controller initiating the delegation
042        * @param target the uri of the target handler that raised the causal exception
043        * @param message exception message
044        * @param cause the causal exception
045        */
046        public DelegationException( URI uri, URI target, String message, Throwable cause )
047        {
048            super( uri, message, cause );
049            m_target = target;
050        }
051    
052       /**
053        * Return the uri identifying the delegation target handler.
054        * @return the URI of the delegate handler
055        */
056        public URI getDelegationTarget()
057        {
058            return m_target;
059        }
060    
061    }
062